.. _ecmPtmSt_GetRunSts:

ecmPtmSt_GetRunSts
==================
------------------


SYNOPSIS
--------


.. code-block:: none

  EEcmPtmSts  ecmPtmSt_GetRunSts(
    t_i32  NetID,
    t_i32  PtmMapIndex,
    t_i32  *RunStepCount,
    t_i32  *RemStepCount,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 이 함수는 PtmMapIndex로 지정된 PT-Motion 맵의 동작상태를 반환합니다.



PARAMETER
---------


- NetID : Network 번호
 
- PtmMapIndex : 이송스텝을 등록하고자 하는 대상 PT-Motion 맵 인덱스.

- RunStepCount : 이 포인터를 통해서 "Run Step Count"값을 반환합니다.

+----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Value          | Meaning                                                                                                                                                                                      |
+================+==============================================================================================================================================================================================+
| Run Step Count | 사용자가 등록한 PT(또는 PV) 이송스텝 중에서 현재까지 실행완료 되었거나 실행 중인 스텝의 개수를 말합니다. "Remained Step Count" 값을 반환 받지 않으려면 이 매개변수의 값을 NULL로 설정합니다. |
+----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

- RemStepCount : 이 포인터를 통해서 "Remained Step Count"값을 반환 합니다.


+---------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Value               | Meaning                                                                                                                                                                                  |
+=====================+==========================================================================================================================================================================================+
| Remained Step Count | 사용자가 등록한 PT(또는 PV) 이송스텝 중에서 아직까지 실행되지 않고 대기 중인 스텝의 개수를 말합니다. "Remained Step Count" 값을 반환 받지 않으려면 이 매개변수의 값을 NULL로 설정합니다. |
+---------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+


- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- :ref:`PtmMapIndex  <ecat_enum_EEcmPtmSts>` 로 지정된 PT-Motion 맵의 동작상태를 반환합니다.


.. seealso::
  :ref:`ecmPtmCtl_Begin EXAMPLE 참고  <ecmPtmCtl_Begin>`